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Preface 



This manual describes the ALLY Application Maintenance Utili- 
ties (AMU) and explains how to use them. 

An introductory chapter describes: 

• the commands to use to access the AMU 

• ways to make menu choices 

• the anatomy of an AMU form 

• data entry techniques 

• the AMU help facility 

Following the Introduction, each chapter corresponds to a specific 
part of the AMU: 

Chapter 2 The Main Menu 

Chapter 3 Security Information 

Chapter 4 Printer Information 

Chapter 5 Access Methods 

Chapter 6 Library AFILEs 

Chapter 7 Auxiliary Utilities 

Chapter 8 Virtual Memory Buffers 

This manual was written for users of applications developed with 
ALLY. Application developers should refer to the Utilities User's 
Guide for additional information about utilities and AFILE 
management. 
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Conventions 



We use the following conventions in this manual: 



Single quotes (* *) 
Boldface type (bold) 

Double quotes (" ") 



Open box (D) 



Angle brackets (<>) 



Identify command names. 

Highlights text you are to enter. Boldface 
is also used within command syntax state- 
ments. 

Identify text strings within text sections. 
These strings are typically located in 
examples or as part of the prompts that 
ALLY sends to your display. 

Sometimes the exact content of a text 
string is affected by the traditional rules 
of punctuation. In these cases, we place 
the closing quotation mark at the end of 
the text string. For example, instead of: 

You see the prompt "Macro number:." 

We say : 

You see the prompt "Macro number:" 

Represents the cursor position in display 
images. 

Enclose a specific key to be typed. Angle 
brackets are used in command syntax and 
key assignment lines. For example: 

<,> the "comma" key. on the 

numeric keypad 
<Return> the "Return" key 
<Do> the "Do" key 
<F18> the "function" key 18 
<2> the "2" on the numeric 

keypad 



End of Preface 
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Chapter 1 
Introduction 



With the ALLY Application Maintenance Utilities (AMU) you 
can tailor your application AFILE (Application Characteristics 
File) to the configuration of your computer system. 

Specifically, the AMU allows you to: 

• change security information and specify the number of 
times users of the application can retry a password before 
being given a security violation. The security information 
you can change controls access to the whole application as 
well as any protected menus, specific forms/reports, indivi- 
dual fields of forms/reports, ALLY Development Language 
(ADL) procedures, and external programs. 

• change the printers, print output files, and spooling device 
the application will be using. 

• change the names of data source files referenced by your 
application's fixed sequential Data Source Definitions. 

• change the names of library AFILEs. This allows you to 
change the names of existing message AFILEs to suit any 
local conventions. 

• run auxiliary utilities. These include utilities to build files 
that describe the terminal and printer on which your appli- 
cation can run. They also include a utility to compile and 
decompile a file of executable macros, and a utility to con- 
vert the data from your application to a text description 
file. 

• change the number of virtual memory buffers assigned to 
your application. 
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Your interface to the AMU consists of menus and forms. The 
menus allow you to select the utilities you want to use. The forms 
allow you to provide information specific to a utility. You use 
menu, form, and text editing commands to move among menus 
and forms. You also use these commands to add, delete, and 
modify information. 

In addition, the AMU provides three kinds of online information 
to aid you during your AMU session. These are legends, help 
messages, and error messages. 

All of these components of the AMU are discussed in the follow- 
ing sections. 



Logon Procedure 



The distributor of your ALLY application has provided an 
operating-system command file for you to use in logging onto the 
AMU. Although each operating system calls for slightly different 
input, the general procedure begins with the cursor on the 
operating-system prompt line. Then: 

Type: The AMU operating-system command filename, fol- 
lowed by < Return > 

Response: At the bottom of your display will appear the prompt 
"Enter the name of the AFILE you want to change:" 

Comment: Your ALLY distributor has provided you with the 
name of the AFILE that contains your application. 
Type that name here. 

If the AFILE you name requires a password for access, you will 
be prompted at the bottom of the display with "Enter the pass- 
word for this AFILE:". 

Once you have correctly typed the password, followed by 

< Return >. the AMU welcome banner appears on the display. 
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Commands 



In the AMU, you use a variety of commands to move the cursor 
among menus and forms and to add, delete, and modify informa- 
tion. You can invoke these commands in one of two ways: 

• Command Menus 

• function and keypad keys 



Command Menus 



First, you can invoke any of these commands from the ALLY 
Command Menus. When you need to invoke a command, type 
<Do> and the Main Menu of the Command Menus will appear 
in the lower third of the display, as shown in Figure 1-1. Then 
make choices on the various menus until you reach the name of 
the command that you need. Next, type the appropriate menu 
choice number and the command will be executed. At the same 
time, the command menu will disappear from the display and the 
cursor will return to the active area of the form or menu in which 
you are working. 
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(Menu or Form! Re port Active Area) 



CannEmd Menu* — Ifain Umax 



1) Task and actdm txiiU-ol 

2) Maw cxmnands 

20 Fcnu/repcrfc ccmsands 
4) Tenet editing ocmnanda 

Your <J mice: 



5) Window 

6) Macro 

7) Beit frod 



Um the 'help' fasgr to get infcnDBtion. 



Figure 1-1. Main Menu of the Command Menus 



As you gain experience in using ALLY commands, you can use 
ALLY'S "menu path" capability. In this approach, to invoke an 
ALLY command, type <Do>. Then on the prompt line for the 
Main Menu of the Command Menus, type the sequence of menu 
choice numbers you would use to arrive at the menu and menu 
choice for the command you need. Separate each number on the 
prompt line with <Space>. For example, to invoke the com- 
mand for exiting from the AMU, you would type 
<Do>KSpace>l<Space>2<Return> on the prompt line of 
the Main Menu of the Command Menus. The Quick Reference 
lists the menu paths for all ALLY commands. 
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Function and Keypad Keys 



The second way to execute many ALLY commands is to type a 
function key or numerical keypad key. The 'help' command, for 
example, is one that can be executed in this way. Refer to the 
Quick Reference to see which ALLY commands are pre-assigned 
to your terminal. You will also find that many text editing com- 
mands can be executed from function keys or the numerical 
keypad. 

You will find more information about ALLY commands in the 
ALLY Command Reference Manual. 



Menus 



The AMU includes two levels of menus. The first level is the 
main menu, while the second consists of five secondary menus, as 
shown in Figure 1-2. 





Main Menu: 
AppScation 
Maintenance 
Utilities 












1 1 










1 




I 


Security 
Information 




Printer 
Information 




Access- 
Method Re 
Names 




Library 
AFILE 
Names 




Auxiliary 
Utilities 



F002-0047-01 

Figure 1-2. The Two Menu Levels of the AMU 
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Making Menu Choices 



The AMU allows you to make menu choices by number, word, 
minimal match, or cursor roam. The following table summarizes 
these ways to make menu choices. 

To Make a Menu Choice: 

From Menu 

Cursor Position: Type: 

Prompt line Number of the choice 

< Return > 

Prompt line Entire underlined word 

< Return > 

Prompt line Prefix of at least two 

letters of underlined 
word 

< Return > 

Highlighted roam area < Return > 



Pick by Number 

The easiest way to make a menu choice is to type the choice 
number on the prompt line, followed by <Return>. 



Pick by Word 

Another way to make a menu choice is to type on the prompt line 
the entire key word, which is indicated on the menu by underscor- 
ing. Then type <Return>. Figure 1-3 shows how this would 
look if you wanted to modify printer information. 



7-6 



UP-12506 



Introduction 



Main Mem 
ATp1.irat.1cn Maintenance Utilities 



1) Modify security 



5) Choose auxiliary utilities 



2) Modify printer 



6) Modify ranker of virtual 
mecory buffers 



3) Modify 
file us 




method 



7) Display an I ntroductor y 
help massage 



4) Modify library 
AFHJ2 names 

Your choice ^printer 



8) Exit main menu 




F002-0270-01 



Figure 1-3. Using Key Word to Make a Menu Choice 



Pick by Minimal Match 



If you prefer, you can type on the prompt line a prefix consisting 
of at least the first two letters (or as many as it takes to make 
your entry unique) of the word underscored in your menu choice. 
Then type < Return >. Figure I -4 shows how this would look if 
you wanted choice 3 of the Main Menu. 
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Main Msnu 
Application Maintanance Utilities 



1) Modify security 



5) Choose auxiliary utilities 



a) Modify printer 



6) Modify mate- of virtual 
man v i y buffers 



3) Modify access method 



f He names 



7) Display an ir.taaijctary 
help DBSsaos 



4) Madlfy lihrary 



8) Bd.t rain raenu 



AFHJE names 
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Figure 1-4. Using Minimal Match to Make a Menu Choice 



Pick by Cursor Roam 



You can also make menu choices by moving your cursor to the 
choice you want. When you invoke a menu in the AMU, the 
cursor appears on the prompt line. The 'first area' and Mast area' 
commands move the cursor to the first and last choices on the 
menu. When the cursor is not on the prompt line, you can move 
it from choice to choice in the menu by using the 'previous area' 
and 'next area' commands. The menu choice the cursor is on is 
highlighted in reverse video. On most terminals, the cursor direc- 
tion arrows are assigned to these commands. 

To make a menu choice using the cursor roam technique, simply 
move the cursor to the choice you want and type < Return >. 
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Using Menu Paths 



The menu-path technique that you can use to move the cursor 
among command menus is also available for quick access to the 
menus and forms of the AMU. 

As you learn your way around the AMU, you may want to go 
directly from the Main Menu to a particular form accessed 
through a secondary menu. To do so, enter the Main Menu 
choice on the prompt line, followed by <Space>, then the 
number of the choice on the secondary menu. 

For example, after you have used the AMU a few times, you will 
probably remember that to modify security information for your 
application you need to select choice I of the Main Menu. You 
may also remember that to modify security information for 
forms/reports you need to select choice 4 of the Security In forma- 
tion menu. 

To move directly to the Security for Forms/ Re ports form from the 
Main Menu, bypassing the Security Information menu, type your 
choice on the Main Menu prompt line as follows and as shown in 
Figure 1-5. 

Your choice: 1<Space>4< Return > 

You can achieve the same result by using word, minimal match, 
or number choice in any combination. For example: 

1 < Space> form < Return > 
or 

se<Space>4< Return > 
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Main Kanu 
Application Maintenance Otilltiea 
Modify ••curlty 5) Chooa* auxiliary utilities 
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Figure 1-5. Using Menu Paths 
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Returning to the Main Menu 



Ail second-level menus of the AMU offer as their final choice 
"Return to main menu." When you make this choice, the cursor 
moves directly to the Main Menu. 

Another way to move to the Main Menu is to type 
"up<Return>" or "top<Return>" on the prompt line of the 
menu where the cursor is located. 



Forms 

The forms that you access from the menus of the AMU are 
designed' to give you three kinds of information. 

As shown in Figure 1-6, the upper-left side of the display is 
reserved for the form itself. The lower third, running the entire 
horizontal length of the display, is reserved for help and error . 
messages provided by the system, and for automatic help messages 
called legends. It is also used by the Command Menus. 

The right third of the display, running the entire vertical length of 
the display, is reserved for "lists of values." The word "work- 
ing..." flashes in the lower-right corner of the display whenever 
the AMU takes longer than a few seconds to execute an action. 

Because these areas overlap, information of one type will some- 
times temporarily overlay information of another type. 



UP-12506 



1-11 



Chapter 1 



Active Area 


List of Values 






Error Messages 


Working... 
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Figure 1-6. The Parts of a Form 



1-12 



UP-12506 



Introduction 



Moving Within a Form 



In all of the forms of the AMU, you can move the cursor from 
field to field with the 'previous field' and 'next field' commands. 
On most terminals, these are the up-arrow and down-arrow keys. 
Other form/report cursor commands that you can use to control 
the cursor within a form are: 



First field 


Last display area 


Last Field 


Next display area 


Next field 


Previous display area 


Previous field 


Delete current record 


First record 


Insert record after 


Last record 


Insert record before 


Next record 


Insert first record in next group 


Previous record 


Move to list of values 


First display area 


Pick from list of values 



Refer to the' Quick Reference to see how to invoke these com- 
mands. 
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Entering Information into the Fields of a Form 



Case Sensitivity 



An AFILE item name in lowercase or a combination of uppercase 
and lowercase letters must be entered into a field exactly as 
represented in the AFILE. 



Table 1-1. Case Sensitivity 



AFILE Item 


Form Field 


Valid? 


order_en tries 


order_entries 


Yes 


ORDER.entries 


order_entries 


No 


Order_Entries 


Order_entries 


No 


ORDER.ENTRIES 


ORDER-ENTRIES 


No 



Scrolling 



Information that you type into the Fields of a form can be longer 
than the space provided on your display. You can see informa- 
tion that exceeds the length provided by using 'right' and 'left' 
commands to scroll the text into view. 

As you will see, not all fields on a form are required each time 
you use one of the utilities. 
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Error Messages 



If your input to a field is invalid, an error message appears at the 
bottom of the display. To clear the error message, type 
<Return>. 



Confirming Data 



Every form of the AMU has a confirmation field. You will know 
that the cursor is in a confirmation field when it rests on a line 
not occupied by an input field. A legend advising you of your 
option to exit or abort also appears. Figure 1-7 provides an exam- 
ple. 



Help AFTLE I 

I 

of help AFTLE: tMt.h I 
□ I 

I 
I 
I 
I 
I 
I 
I 
I 
I 
I 
I 



Figure 1-7. AMU Form with Cursor in Confirmation Field 

The cursor moves to the confirmation field after it leaves the last 
input field for a form. If the information on the display is 
correct, use the 'exit action' command. However, if the informa- 
tion is not what you want, you can use the 'first field' command 
to return the cursor to the first field of the form. You can also 
use the 'abort action' command to return to the previous menu 
without committing any of your input. 
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Using a List of Values 



Lists of values save typing time and keep you from putting invalid 
data into the forms of the AMU. 

In the AMU, a list of values includes all valid entries for the 
related field. Whenever a list of values appears on the display, 
you can make an entry into the field in one of two ways: 

• Type an entry, using the list of values as a reminder of the 
values that are valid for the field. 

• Use the 'move to list of values' command to move the cur- 
sor to the top of the list of values. Next, use the 'next 
record' command to move the cursor to the value you want 
to enter into the field. (If the list of values is longer than 
the space allocated for it on the display, the list will scroll 
upward, one "page" at a time, with each use of the 'next 
area* command.) Then, use the 'pick from list of values' 
command. The value you have selected will be entered to 
the appropriate field and the cursor will return to the active 
area of the form in which you are working. 

In the form represented in Figure 1-8, the cursor is in the field for 
"Item name for global information security" and the list of values 
represents all valid security item names. 
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Security for Global Information 



Item autt for global 
information security: Q 



| List of security 
| item ntaat 
I J*ME_DOE_OMI 1 Y 
, SYSTEM SXCDRZTT 



Move to fist of values 



Security for Global Information 



Itam nam* for global 
information aaourity : 



| Li at 
j item 



of aaourity 
nana a 

I QJIMI_D0X_0XLT 
! SYSTEM SECURITY 



Down 



Security for Global Information 



Item name for global 
Information amour! ty: 



| List of aaourity 

j item namea 

■ JAM* DOB ONLY 



@YSTEM_SECURITT 



Pick from Bst of values 



Security for Global Information 
Item nam* for global 

Information aaourity: SYSTEM SECURITY 

o 



Figure 1-8. Using a List of Values 
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Parts of a list of values may be temporarily covered up when the 
system displays a help message. When you remove the help mes- 
sage from the display (by typing <Return>). the list of values 
appears again in its entirety. 
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Leaving a Form 



You can leave a form in one of two ways: 

1 ) Exit action 

2) Abort action 

These two ways of leaving a form commit (save) information dif- 
ferently. The amount of information committed depends upon 
the position of the cursor in a record. 

A record consists of a group of logically related fields. In Figure 
I -9, for instance, each name of a security AFILE item represents 
a field, and each password represents a field. A record here con- 
sists of a name and the password assigned to it. 



Security AFILE Ifcata 

Name of security AFILE itm Password 

OJHn , _3ESr_AlXESS OpeN 

EXETLfEELRE PDQ436H 

SYSTEM-SECURITY PASSWORD 



Figure 1-9. Fields and Records 



If you use the "abort action' command before the cursor leaves the 
last field of a record, none of your entries to the fields of that 
record are committed. However, changes you make to any 
records that you leave by typing <Return> or by inserting a new 
record, will lie committed, even if you later use the abort action* 
command. 

On the other hand, when you use the 'exit action' command, all 
of the data you enter to the form is committed, no matter where 
the cursor is located in a record. 
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Help Facility 



The AMU provides two different sources of help as you work: 

• Automatic help messages, called legends 

• On-demand help messages 



Legends 



Some help messages appear automatically when you move the cur- 
sor to the fields of forms. These automatic help messages are 
called legends, and they disappear when the cursor leaves the field 
or form to which they are relevant. 

Legends provide information you will find useful for filling out 
forms. They will also remind you of the exit and abort options 
available. 



On-Demand Messages 



On-demand help messages provide additional information about 
fields and forms. In addition, most messages tell you something 
about the kind of entry a field will accept and default values that 
may be assigned to the field. 

You can access the help facility for the AMU by using the "help* 
command. If the cursor is in a form when you invoke the 'help* 
command, the help message displayed will apply to that form and 
all of its fields. 

If the cursor is in a menu when you invoke "help*, the message 
that appears at the bottom of the display will be relevant to the 
menu and all of its choices. 

If the cursor is in a help message when you invoke help*, the 
message that appears describes the help facility and how to make 
menu choices. 
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How to Use On-Demand Help Messages 



When a help message initially appears on the display, you will see 
only its first eight lines. These lines summarize information about 
the fiekl, the form, the menu, or the entire AMU. They also 
contain the following note: 

+ + 

I To return to the applica- I 
I tion, type <Return> . I 
I To see the rest of this I 
I message, use 'down page ' . I 
I For more help, use 'help'. I 
+ + 

Some additional commands you can use to move around within a 
help message are these: 

• Use the 'explode window' command to see a full 24 lines of 
the help message. 

• Use the *up page' command to move toward the beginning 

of the message. 

•' Use the cursor movement commands to move up and down 
within the text of the help message. 

• Use the 'find' command to search for a particular menu 
choice or field name in the message. 



To Exit From a Help Message 



You can exit from a help message in two ways. 

• Type < Return > to move the cursor back to the applica- 
tion. This deactivates the help message. To see the help 
message again, follow the procedure outlined above. 

• Use the toggle task' command to return the cursor to the 
application. This keeps the help message available, no 
matter where in the application you are. To return to the 
help message, use the 'toggle task* command again. 
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Error Messages 



Many error messages are also built into the AMU. These appear 
automatically in the bottom two lines of your display whenever 
you type invalid or incomplete information. For example, if you 
use the next field' command when the cursor is in the last field of 
a form, you will get the following message: 

You tried to rare to the next or last field of the report. 

The cursor is already in the last enterable field of the report. 

The text of error messages is usually two lines long. On a third 
line, which is not visible when the message first appears on the 
display, is an error number. If you are asked for this number by 
your system manager or ALLY distributor, type the 'down' com- 
mand to reveal the number. 

To clear an error message from the display, type < Return>. 
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Summary of Commands 



To: 



From 

Cursor Position : 



Type: 



Ch(X)se menu option 



Get help 

Exit from a help or 
error message 

Move cursor among 
fields 

Move cursor into list 
or values (LOV) 

Copy value from 
LOV to form field 

Abort action 

Exit form with update 



Prompt line 
Prompt line 



Number of choice 

< Return > 

First two letters of 
underlined word in the 
menu choice 

< Return > 



Highlighted roam area <Return> 

Menu choice or form <Help> 
field 



Che message 

A form field 

Form field 

LOV 

Any place 
A form field 



< Return > 

Field, record, & 
display area commands 

'move to list of values' 
command 

'pick from list of 
values' command 

'abort action' command 

'exit action' command 



End of Chapter 1 
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The AMU Main Menu 



When you type < Return > to leave the Application Maintenance 
Utilities welcome banner, the Main Menu for the AMU appears 
on the display, as in Figure 2- 1 . 



Main Menu 
Application Maintenance Utilities 


1} Ifodify security 


5) Qicoee auxiliary utilities 


2) Modify printer 


6) Modify nuebar of virtual 
mancry buffers 


3} Modify access* Method 
file names 


7) Display an introductory 
help massage 


4) Modify library 
AFHJE name 


8) Belt BBdn BBnu - 







Figure 2-1. Main Menu: Application Maintenance Utilities 
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Summary of Choices 



Figure 2-2 shows the choices available from the Main Menu of the 
Application Maintenance Utilities. 



Security 
Information 



K5> 



Printer 
Information 



Main Menu: 
Application 
Maintenance 
Utilities 

I 



8 

Operating System 



Access- 
Method Fte 
Names 



i 



Auxiliary 
Utilities 



<!> 



Ubrary 
AFILE 
|ames 



Virtual 
Memory 
Butters 



Introductory 
Help 
Message 



F002-0273-01 



Figure 2-2. Main Menu Choices 



Tlie first five choices give you access to secondary menus. 

Choice 6 of the Main Menu invokes a form on which you can 
modify the number of virtual memory buffers assigned to your 
application. 
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Choice 7 invokes a help message that describes the Application 
Maintenance Utilities, tells you how to make menu choices, and 
describes the help facility. 

Choice 8 takes you out of the Application Maintenance Utilities 
and returns control to the operating system. 



End of Chapter 2 
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Security Information 



The AMU allows you to control the security of your application at 
several levels. 

Your ALLY application is stored in an AFILE — short for Appli- 
cation Characteristics File. The AFILE is made up of many 
AFILE items, each of which describes a different characteristic of 
the application. 

Among those characteristics are specific security items, each with 
its own name. Each security item can have one password and can 
be assigned to one or more other AFILE items in the application. 
Figure 3-1 illustrates this structure. 
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Security 
AFILE 
Items 





AFILE 






item name: 
SEC_ITEM_FR 




Item 






Password: 
PDL229 






Item 






Hem name: 
SYSTEM_SECURE 

Password: 
NVRMRE 




Item 






Item 


Form/Report 


Item 




Name: 
XYZ.FR 




Security Item: 
SECJTEM_FR 



F0O2-O054-O1 

Figure 3-1. Security AFILE Items 

Common reasons for modifying security information for an appli- 
cation are to: 

• create new security items 

• change passwords for security items 

• assign passwords to security items 

• assign security items to any of the parts of your application 
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• specify the number of times users can try to enter security 
information 

When you pick choice 1 from the Main Menu, the display will 
show the menu for modifying security information, as in Figure 

3-2. 



Security Information 


1) Add, delete, cr modify 


5) Modify field security In 


a security AFILE item 


a fann/reparfc 


2) Modify security for 


6) Modify ACL security 


global information 




3) Modify menu security 


7) Modify external program 


security 


4) Modify f era/report 


8) Modify security retries 


security 






9) Return to main menu 


Your choice: 





Figure 3-2. Security Information 



The choices available from this menu are discussed below. 



Security AFILE Items 



When you pick choice 1 from the Security Information menu, you 
invoke the form for adding, deleting, and modifying security 
AFILE items, as shown in Figure 3-3. 



UP-12506 



3-3 



Chapter 3 



Security 


AFILE Item | 


Masts of security- AFILE item 




CUENEJESOOCEBS 


QpaN | 


E3<EELSEELRE 


PDQ43EH | 


StSTBLSBJJBITf 


PASSWORD | 



Figure 3-3. Security AFILE Item 



The names we have entered under the columns for "Name of 
security AFILE item" and "Password" are examples and will not 
match the actual items that appear on the display the first time 
you access this form. 

When this form appears on the display, the cursor is in the first 
field, under the column heading "Name of security AFILE item." 



Entering Information About Security Items 



Add Security Item 



Move the cursor to any field and use the 'insert record before' or 
the 'insert record after' command. Then type a security AFILE 
item name and password in the appropriate fields. You may add 
as many new records to this form as you need. 

If no security items have been defined when you access this form, 
the cursor will be in the confirmation field. To insert security 
AFILE items, use the 'insert first record in next group* command. 
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Delete Security Item 



Use the 'delete record* command to remove a security item. If 
you mistakenly use the 'delete line' or 'delete character* com- 
mand, you will receive an error message telling you that you have 
left blank a field that requires a valid item name. 



NOTE: Do not try to delete a security item while it is still 
assigned to another menu, form/report, or A FILE item. If you 
do, you will get an error message. 



Modify Security Item 



Use text editing commands to modify any security item name. 



Entering Information about Passwords 



A password can be added, deleted, or modified for any item that 
is defined in the left column of the Security AFILE Item form. 
However, you cannot create a password for a security item that 
does not exist. 

You may assign the same password to more than one security 
item. You may also leave some security items without a pass- 
word. This means that no password checking will be done for the 
AFILE item that is connected to this security item. 
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Security for Global Information 



Choice 2 of the Security Information menu allows you to assign a 
security AFILE item to the global information of your ALLY 
application. 

The password that you assign to the security item for global infor- 
mation will l>e the password required for logging onto the AFILE 
with the AMU. To limit runtime access to the ALLY applica- 
tion, you will need to assign a security AFILE item and password 
to the main menu of the application or to any other application 
entry point. In other words, global security protects the applica- 
tion from AMU modification, while menu, form/report, and other 
levels of security protect it from unauthorized use. 

To make it possible to logon to the AFILE without specifying a 
password, be sure that the field for "Item name for global infor- 
mation security" is blank. 

The form for modifying security for this global information looks 
like Figure 3-4. 



Security far Global Information 


1 


1 List, of ■ecurlty 


I tan nana far global 


I itOUBBM 


information aecurity: SYSTQLEEEURITY 


1 (UEKT_JEST_fOCESS 








1 GftsnaLEBXjRrrr 

1 

1 

1 

1 

1 

1 

1 

1 

1 



Figure 3-4. Security for Global Information 
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NOTE: If the security AFILE item you want to assign to global 
security does not exist, take these steps to create it: 


1) 


Leave this form with the abort action command. 


2) 


Select choice 1 of the Security Information menu to 
invoke the form entitled Security AFILE Item. 


3) 


Add the new security AFILE item, along with a pass- 
word for the item. If no items exist when you access the 
form, use the insert first record in next group' com- 
mand. 


4) 


Exit from the form. 


5) 


Select choice 2 of the Security Information menu to 
invoke the form entitled Security for Global Information. 


6) 


Assign the new security AFILE item. 



Use the 'move to list of values' command to move the cursor into 
the list of security items. Then use the 'next record' and 'previous 
record' commands, and the other form/report cursor movement 
commands to move the cursor to the item that you need. Then, 
use the 'pick from list of values' command to copy the security 
item to the field. 

If you prefer, you can simply type into the field the name of the 
security AFILE item you want to assign to global information. 
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Security for Menus 



Choice 3 of the Security Information menu allows you to assign 
security items to the menus of your ALLY application. 

When the form appears on the display, it will look much like Fig- 
ure 3-5. 





Security far Menus 


1 List of security 


tfawiB of ooroi 


Security itan name 


1 item toutu 


MADLMSNU 




1 CUENEJESTJIGCEBB 


SUBSLBEP-MENJ 




I BCEg_SB3JRE 
I SYSIElCSSnJUTY 



Figure 3-5. Security for Menus 



The left column of this form lists the menus of your application. 
The distributor of your application has created and named the 
menus that appear in this list and the AMU does not allow you to 
change these names. 

The "List of security item names" includes all valid security items 
that can be assigned to the various menus. 

For each menu to which you want security assigned, type the 
name of a valid security AFILE item. Or, use the 'move to list of 
values' and 'pick from list of values' commands to select an item 
from the list. 
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Security for Forms/Reports 



Choice 4 of the Security Information menu allows you to assign 
security AFILE items to any form/report packet of your ALLY 
application. 

A form/report packet consists of a form/report plus a set of 
characteristics that govern invocation and use of that form/report. 
For example, an application might have a form/report referenced 
by two different packets. The first packet might cause the initial 
mode of the form/report to be "insert" while the second packet 
might cause the initial mode to be "query by example." 

When the form for modifying form/report security appears on the 
display it will look much like Figure 3-6. 



Security for 


Fanns/Hepcrt* 




Nans of 




1 List of Mcurltj 




Security item roam 






SYSTEH-EEELRTTf 


i CIJENT_Jti>I_AOCESS 


SLBS-FOftLFKT 


SYSlQCffELRlTf 


1 EXFELfFEUFE 


E*P_SJBSJflEPJflCr 




1 SYSTBCffELRTIY 


LIST_flB6-PKT 








EXEELffEURE 




RBSJEP-JKT 


CUEHT_JEST_fGCEEB 




RJBEL5UBELfEP_PKr 












8U35JEPJPKT 


OJENT_JESOCCESB 





Figure 3-6. Security for Forms/Reports 



When the form appears on the display, the cursor is in the first 
record under the column heading "Security item name." Add a 
security item for each form/report packet that you want secured. 
Do this either by typing in a security item name or by copying one 
from the list of values. 

Remember, you may leave form/report packets unsecured if you 
wish. 
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Security for Fields in a Form/Report 

Choice 5 of the Security Information menu allows you to assign a 
security AFILE item to any field of any form/report. While it is 
unlikely that you will need such extensive security, you may find 
it useful to assign security to at least some fields of some 
forms/ reports. 

When you pick choice 5, a form appears, as in Figure 3-7, allow- 
ing you to name a form/report whose fields you want secured. 





Security f cr Fields 


1 






I List of 


Farm/report, nam 




1 t ccn/reparta 






1 JUXLft&ftRi 






I StBSJTOf 






1 LIST-PUBS 






1 ICELFiajTOM 






1 RJBS_BEP 






I FU3S_0UBS_BEP 






1 RRJint 






1 GUBSJEP 

1 

1 

1 

1 



Figure 3-7. Security for Fields in a Form/Report 



Type the name of the first form/report that contains fields you 
want secured. As usual, you can either type the name into the 
field or copy it from the list of values by using the 'move to list of 
values' and 'pick from list of values' commands. 

When you have specified a form/report name, type <Return> 
and another form appears on the display, listing all fields of the 
specified form/report, as in Figure 3-tS. 
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Security fcr Field* 


i 

j 


Fcn^repcK L name: 




| 
| 


Nana of 




1 List of security 


fcnn/repart field 


Security iten name 


1 iten nanea 


oqjwe 


GLIENr_lfci>I_/CCESE 


1 <UENT_JEST_J£XESS 


CXLMWBER 




1 EXEELEEELRE 


DOdJNl 




1 SW5IEM, ESDURTTY 


D0QJN2 


SYSTEVLEEEURTTY 




nmnH 






BF_fJC 


SYBTOLEEDLRITf 




EMPJiDC 







Figure 3-8. Subform for Field Security 



For any of the fields listed, specify a security AFILE item from 
the list on the right side of the display. 

Once you have assigned security to all form fields that you want 
secured, use the 'exit action 1 command to return to the Security 
Information menu. 

If you want to secure fields on other forms, select choice 5 and 
repeat the process described above. 
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Security for ADL 



Choice 6 of the Security In formation menu allows you to assign a 
security A RLE item to any ADL (ALLY Development 
Language) procedures that are part of your, application. When 
you assign a password to an ADL procedure, an application user 
will have to type the password each time the procedure executes. 

When you pick choice 6, a form , much like that in Figure 3-9, 
appears on the display. 





Security far ACL 


1 List of security 


ADL item name 


Security item name 


1 item pi 


CranC3*WMEL/EL 




1 CLiEKr_jEsr_ja£ss 


DOTLVAUJL/DL 




1 EXBUWIBE 


DAreLVAL_2JU3L 




1 SYSIEM^BXRITY 


DMELVAUJLADL 












DQXIN1_ADL 






IXXXIN2-AEL 






aXUN3_/CL 






FREXL2JML/DL 






FREU_3_VAL^CL 






FRBLyALJUJL 




1 



Figure 3-9. Security for ADL 



Names of ADL procedures that are part of your ALLY applica- 
tion* will be present. You cannot modify this list. 

For each ADL item, you can assign a security item name from 
the list of values. 

As usual, you can leave an ADL procedure unsecured simply by 
not specifying a security item for it. 
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Security for External Programs 



Choice 7 of the Security In formation menu allows you to assign a 
security A FILE item to any external program that is part of your 
ALLY application. 

External programs include any programming code that the 
developer of your ALLY application has built into the application. 

The form, as it appears on the display, will look something like 

Figure 3-HL 



Ssoirity for E 


Eternal Ppogfrasss 




Itesa kbb for 




1 List of security 




Ssscurity itea name 




BROADCAST 




1 QJENT_JEST_AOCEEB 


raii.'frjjc 




| E3QUEOBE 






I EYBTTiLfFIlRrTY 



Figure 3-10. Security for External Programs 



Add security to any of these items by assigning a security AFHLE 
item from the list in the right column of the display. 
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Security Retries 



Choice 8 of the Security Information menu invokes a form that 
allows you to specify the number of times (after the first time) 
that you want users to be allowed to try to access the secured 
parts of the application. See Figure 3-11. 



Security Retries 



Figure 3-11. Security Retries 

Type any number in the range of 0 to 65535. Then use the 'exit 
action* command to return to the Security Information menu. 



Return to Main Menu 



Choice 9 of the Security Information menu returns you to the 
Main Menu of the AMU. 



End of Chapter 3 
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Printer Information 



Choice 2 of the Main Menu for the Application Maintenance Util- 
ities allows you to name different printer description files, print 
output files, and spooling devices for your application. It is also 
the means by which you can assign the forms/reports of the appli- 
cation to different print output files. See Figure 4-1. 



• Printer Tot Qpnatd m 

1) Ifodlfy global printer inf tarnation 

2) l&xUfy f era/report printer file 

3) Return to Bain menu 



Your choice: 



Figure 4-1. Printer Information 



Global Printer Information 



Pick choice 1 of the Printer information menu to access the form 
for specifying information about the printer files and spooling dev- 
ice you want to assign to the application as a whole. As shown in 
Figure 4-2, the form for specifying global printer information has 
three fields that you must fill in. 
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If you specify a spooling device but no output file, whatever you 
want printed goes directly to the printer assigned. If you specify 
an output file but no spooling device, what you want printed goes 
only to the file and each successive print command overlays that 
file with the newly printed information. In either case, you must 
specify a printer description file. 



Global Printer Ihf carnation 
Name of output file: printfilo 
Printer description file: DEFAULT 
Printer spooling device: apool^file 



Figure 4-2. Global Printer Information 



Entering Information 



1 ) Name of output file: Type the name of the file to which 
you want print output sent. 

2) Printer description file: Type the name of the file that 
contains the character mapping information for your 
printer. 

3) Printer spooling device: Type the name of the device or 
routine your operating system uses to buffer or queue the 
print requests you make. 
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Printer Information 



NOTE: For all fields of this form, be sure that the names you 
enter are accurate and compatible with your operating system. 
ALLY does not validate this information for you. 



Form/Report Printer Files 



Choice 2 of the Printer Information menu invokes a form on 
which you can assign different forms/reports to different print out- 
put files. A sample of this form appears in Figure 4-3. 



ForVRepcrt Printer Files | 

I 

Kb of printer file | 

I 
I 
I 
I 
I 
I 
I 
I 
I 
I 
I 
I 



Figure 4-3. Form/Report Printer Files 



NOTE: If you do not specify a print output filename for any of 
the forms/reports of your ALLY application, the printer 
description filename you specified on the Global Printer Infor- 
mation form will serve as the default. 



In the left column of this form is a list of all of the form/report 
packets that are part of your ALLY application. Since you can- 
not change form/report packet names, the cursor will not enter 
these fields. 



Kane of font/report p a df fc 
ACCLSJOJOMJICr 




LISTJPlBS-FKr 
lauUELFOHJKT 
PUBSJSPJW 



Fuajtnuvr 

SLB5_PEP_flCr 
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Entering Information 



• Name of printer file: Type the name of the print output file 
for each form/report that you want assigned to a printer 
file. Any form/report packet that is not assigned its own 
printer file is automatically assigned to the global printer 
file. 



End of Chapter 4 
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Access-Method File Names 



Choice 3 of the Main Menu invokes the menu shown in Figure 

5rl. 



File 

1) IfadUjr find •squantial Data Sburoa Daf Initial 
S0 Battsn to mSn n 



Your cJnniowt 



Figure 5-1. Access-Method File Names 

You will need to access this menu only if fixed sequential files 
provide the data for your ALLY application. 



Fixed Sequential Data Source Definitions 

Choice l invokes a two-column form, as shown in Figure 5-2. 
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Fixed Sequential Dttta Sburcs Def initial 

Data Source Definition 
CDBT_£EMIER 
Bff» 
FUB5 
SUBS 



Figure 5-2. Fixed Sequential Data Source Definitions 

The first Held in each record displayed on this form is one that 
you cannot alter. 



Entering Information 



• Name of fixed file: Type the name of the data file that is 
referenced by the fixed sequential Data Source Definition 
that appears in the left column. Then type < Return > to 
go on to the next, or use the 4 exit action' command to save 
your changes and leave this display. 

Keep in mind that ALLY does not verify that the filenames you 
provide are valid for your operating system. 



End of Chapter 5 



feme of fixed file 



pubs 
subs 
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Library AFILE Names 



The legends and help messages for your ALLY application can be 
stored in an AFILE separate from the application itself. The 
error messages for your application can also be stored in a 
separate, or library AFILE. 

Choice 4 of the Main Menu allows you to change the names of the 
AFILEs that contain the help and error messages for your appli- 
cation. Some of the reasons you might want to change these 
names are as follows: 

• to allow for foreign-language help and error messages 

• to reflect changes in filenaming conventions on your system 
or to reflect changes your system administrator makes in 
the ALLY installation 

When you pick choice 4 of the Main Menu, the menu entitled 
Library AFILE Names appears, as shown in Figure 6- 1 . 



Library AFILE Naaaa 
1} IfadHjr on of halp AFILE 
2D Modify nans of arrcr /FILE 
3) Return to sain ami 



Your choice: 

Figure 6-1. Library AFILE Names 
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Help AFILE 

Choice 1 of the Library AFILE Names menu invokes the form on 
which you can change the name of your help AFILE, as shown in 
Figure 6-2. 



Help AFILE 
Ham of help AFILE: teat.h 



Figure 6-2. Help AFILE 



Use text editing commands to change the name of the help 
AFILE. 
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Error AFILE 

Choice 2 of the Library AFILE Names menu invokes the form 
shown in Figure 6-3. 



Figure 6-3. Error AFILE 



Use commands for 'delete character", 'delete line', and other 
text-editing keystrokes to change the name of the error AFILE. 



End of Chapter 6 
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Auxiliary Utilities 



Choice 5 of the Main Menu gives you access to ALLY'S auxiliary 
utilities. These include utilities for building printer and terminal 
description files, a utility for converting data that is stored in your 
application to text form, and a utility for compiling and decompil- 
ing ALLY macro files. The menu in Figure 7-1 displays the six 
choices available. 



Auxiliary Utilitlaa 

1) Run the Terminal Mlar 5) Dacaapila an ALLY 

Macro 

20 An tha Prints- Daflnar 

fl) ttm to prerloua n 

20 Run tha Data Migrator 
4) Cbnpila an ALLY Macro 



Your choice: 



Figure 7-1. Auxiliary Utilities 



Terminal Definer Utility 



Choice I of the Auxiliary Utilities menu invokes the form shown 
in Figure 7-2. 
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Terminal Daf lnar Utility 
Name of format file: 
Description file to build: 
Name of terminal : 
Name of key definition file: 
Name of terndef file: 
EkiLt conflict checking: 



Figure 7-2. Terminal Definer Utility 



Entering Information 



1) Name of format file: This is the Format File that is part 
of your ALLY software. Your system manager or 
ALLY distributor can provide this information. 

2) Description file to build: Specify a name for the file that 
will contain a terminal's character mapping information. 
This name must be compatible with the naming conven- 
tions of your operating system. 

3) Name of terminal: Type the ALLY mnemonic from the 
termdef file that identifies the terminal for which you are 
building this description file. Your system manager or 
ALLY distributor can provide this information. 

4) Name of key-definition file: Type the name of the file 
that specifies the key-to-command assignments for the 
terminal named above. Your system manager or ALLY 
distributor can provide this information. 

5) Name of termdef file: Type the name of the file that lists 
your terminal's capabilities. Your system manager or 
ALLY distributor can provide this information. 
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6) Edit conflict checking: Type <Return> to accept the 
default level of checking for conflicts in commands 
assigned to keys in the. key-definition file. By default, 
the command assignment for every key is compared to 
the assignment for each key in the global sections. 

Type "Y<Return>" to display the subform that lists the 
levels of conflict checking. Type **X" in the field of a 
level that you want to select. Table 7-1 describes these 
levels. 

Table 7-1. Terminal Definer Options 



Option 

Every set of global keys 



Action 



Compare each key in 
the key-definition file 
for conflicts with the 
keys assigned in the 
two global keys sec- 
tions 



Other sets of keys 



Other keys in the same set 



Do no conflict checking 



Compare every key in 
the key-definition file 
with every other key 
in that file for a con- 
flict in assignment 

Compare each key in 
the key-definition file 
with other keys in the 
same section for a 
conflict in assignment 

Compare no keys in 
the key-definition file 
for conflicts in assign- 
ment 
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Building the Terminal Description File 



When you exit from the confirmation field of this form, the cursor 
will move to the lower-left corner of the display while ALLY 
builds the terminal description file from the components you have 
listed. When the file has been built, the cursor will return to the 
Auxiliary Utilities menu. 



Printer Definer Utility 

Choice 2 of the Auxiliary Utilities menu invokes the form shown 
in Figure 7-3. 



Printer Definer Utility 
Name of format, file: 
Description file to build: 
ffeme of printer: 
Kama of prinbdef file: 



Figure 7-3. Printer Definer Utility 



Entering Information 



1) Name of format file: This is the Format File that is part 
of your ALLY software. Your system manager or 
ALLY distributor can provide this information. 

2) Description file to build: Specify a name for the encoded 
file you want ALLY to build. This name must be com- 
patible with the naming conventions of your operating 
system. 
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3) Name of printer: Type the ALLY mnemonic from the 
printdef file that identifies the printer for which you are 
building this description file. Your system manager or 
ALLY distributor can provide this information. 

4) Name of printdef file: Type the name of the file that lists 
the capabilities of the printer for which you are building 
the description. file. Your system manager or ALLY dis- 
tributor can provide this information. 



Building the Printer Description File 



When you exit from the confirmation field of this form, the cursor 
will move to the lower-left corner of the form while ALLY builds 
the printer description file from the components you have listed. 
When the file has been built, the cursor returns to the Auxiliary 
Utilities menu. 



Data Migrator Utility 



Choice 3 of the Auxiliary Utilities menu invokes the form you use 
to run the Data Migrator. 

The Data Migrator performs these operations: 

Text writing Translates the data that is stored in your 
application into a text description file 

Text reading Produces or appends the data from a text 
description file to the data that is stored in 
your application 

Figure 7-4 shows an example of the text file that is produced by 
the Data Migrator in its text writing operation. The parts of a 
Data Migrator description are iabeled and explained in the para- 
graphs that follow the example. 
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Data Referenced by Base Definition erplcjnee (^) 

© 

© 



There are 4 fields in each record 
CHAR (25) DATE CHAR (25) MISER (FIX. 7,2) 



The following is a script write of the actual data 
(8): Jane Doe (19) :01/05/1978 00:00:00 (9) : 177439456 (5):24CC0 

(8): John Doe (19) : 06/08/1884 00:00:00 (9) : 077349334 (5): 18000 ^-^ 

w 

(10):Tlt*w Canbee (19) :O4/01/1933 00:00:00 (9) : 123456789 (5):21000 w 



Figure 7-4. Sample Text Description of Data from a DSD 

The Delta Migrator description contains: 

1) A header indicating the source of the data (the Base 
DSD name). 

2) The number of fields in a record and the attributes of 
each field. 

3) A number within parentheses that precedes each field 
value and tells the Data Migrator the number of charac- 
ters to read at a time. 

4) The text description of the actual data. 

In the text reading operation, the Data Migrator can process a 
text file and produce a dataset, file, or table in the database. The 
Data Migrator does not examine any of the access- method- 
dependent file or field AFILE items. Therefore, it cannot pro- 
vide status on the existence or compatibility of an output data file. 

For a fixed sequential data file, this output file has the name that 
is specified in the access-method-dependent structures of the Base 
DSD. If the file already exists and is fixed sequential in the same 
record format, the new records are appended. If the file exists 
but is not fixed sequential, or the record format differs, the resul- 
tant output file may be corrupted. 
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Data Migrator Utility Options 



The two Data Migrator options are described in Table 7-2. 
Table 7-2. Data Migrator Utility Options 



Option Action ____ 

Read the text file Creates or inserts data from a text file 
into a dataset, file, or table in an access 
method 

Write the text file Creates a text file from a data file refer- 
enced by an A FILE'S Base DSD 



As shown in Figure 7-5. the Data Migrator utility requires five 
items of information. 



ALLY Data Migrator Utility 

Kama of fcrasst file: 

Hams of AFTLE containing 
tha Data Sburce Definition: 

Pasa-sord for AFTLE: 

ffesas of Data Source Definition: 

Nana of output data, file: 



Figure 7-5. Data Migrator Utility 
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Entering Information 



1) Name of format file: This is the format file that is part of 
your ALLY software. Your system manager or ALLY 
distributor can provide this information. 

2) Name of AFILE containing Data Source Definition: 
Type the name of the AFILE that contains the Data 
Source Definition whose data you want translated to a 
text file. 

3) Password for AFILE: Type the password needed to logon 
to the AFILE. If no password has been assigned for 
logon to the AFILE, type < Return >. 

4) Name of Data Source Definition: Type the name of the 
Data Source Definition whose data you want migrated to 
a text file. 

5) Name of output data file: Specify a name for the file that 
will contain the text description of the data. After exit- 
ing from this field, the cursor will move to a subform 
that displays the options for the Data Migrator. Type 
**X<Return>" in the field of the option you select. 

When you exit from this form, the cursor will move to the lower- 
left corner of the form while the Data Migrator runs. To return 
to the Auxiliary Utilities menu without running the Data Migrator, 
use the 'abort action' command. 



Macro Utility 



If you have ALLY on multiple environments, you can use the 
Macro Utility to move macro files among the environments. 
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Compiling a Macro 



Choice 4 of the Auxiliary Utilities menu invokes the form shown 
in Figure 7-6. 



ALLY Macro lAllltgr— CbnpLle a Macro 
Maine of format file: 
Kane of input file: 
Name of output file: 



Figure 7-6. Running the Macro Utility to Compile a Macro 



Entering Information 

1) Name of format file: This is the Format File that is part 
of your ALLY software. Your system manager or 
ALLY distributor can provide this information. 

2) Name of input file: Type a name for the file built by the 
Macro Utility that contains the ASCII text version of an 
ALLY macro file. 

3) Name of output file: Specify a name for the file that will 
contain the executable macro(s). 

When you exit from the confirmation field of this form, the cursor 
will move to the lower-left corner of the display while the Macro 
Utility runs. When the macro file has been compiled, the cursor 
returns to the Auxiliary Utilities menu. 
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Decompiling a Macro 



Choice 5 of the Auxiliary Utilities menu invokes the form shown 
in Figure 7-7. 



ALLY Macro lAi21ty~-Oeaaap±le a Macro 
Hams of format file: 
(feme of input file: 
Kama of output file: 



Figure 7-7. Running the Macro Utility to Decompile a Macro 



Entering Information 

1) Name of format file: This is the Format File that is part 
of your ALLY software. Your system manager or 
ALLY distributor can provide this information. 

2) Name of input file: Type the name of a file that contains 
the executable version of an ALLY macro. 

3) Name of output file: Specify a name for the file that will 
contain the ASCII text version of the macro. 

When you exit from the confirmation field of this form, the cursor 
will move to the lower-left corner of the form while the Macro 
Utility runs. When the macro has been decompiled, the cursor 
will return to the Auxiliary Utilities menu. 



End of Chapter 7 
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Number of Virtual Memory Buffers 

Choice 6 of the Main Menu accesses the form shown in Figure 
8-1. 

Your system manager or ALLY distributor can provide informa- 
tion about virtual memory buffers and your operating system. 



tfcnbar of VM buffers 
NuBbsr of virtual unary buffer*: 300 



Figure 8-1. Number of Virtual Memory Buffers 

Two virtual memory buffers are the equivalent of Ik (I024 bytes) 
of memory. In general, the more virtual memory buffers you 
assign, the less often data will have to be written to and read from 
disks. 



Entering Information 



• Number of virtual memory buffers: Type a number 
between I and 65535. 



End of Chapter 8 
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